3D Graphics Programming with QuickDraw 3D 1.5.4

Managing Shape Parts and Mesh Parts

QuickDraw 3D provides routines that you can use to get shape parts and mesh parts and to determine the shape objects that correspond to those parts. They use these types:



 
typedef TQ3ShapePartObject      TQ3MeshPartObject;

typedef TQ3MeshPartObject       TQ3MeshFacePartObject;

typedef TQ3MeshPartObject       TQ3MeshEdgePartObject;

typedef TQ3MeshPartObject       TQ3MeshVertexPartObject;

Q3ShapePart_GetShape

You can use the Q3ShapePart_GetShape function to get the shape object that contains a shape part object.



 
TQ3Status Q3ShapePart_GetShape (

                     TQ3ShapePartObject shapePartObject, 

                     TQ3ShapeObject *shapeObject);

shapePartObject: A shape part object.
shapeObject: On exit, the shape object that contains the specified shape part object.

DESCRIPTION

The Q3ShapePart_GetShape function returns, in the shapeObject parameter, the shape object that contains the shape part object specified by the shapePartObject parameter.

Q3ShapePart_GetType

You can use the Q3ShapePart_GetType function to get the type of a shape part object.



 
TQ3ObjectType Q3ShapePart_GetType (TQ3ShapePartObject shapePartObject);

shapePartObject: A shape part object.

DESCRIPTION

The Q3ShapePart_GetType function returns, as its function result, the type identifier of the shape part object specified by the shapePartObject parameter. If successful, Q3ShapePart_GetType returns this constant:



 
kQ3ShapePartTypeMeshPart

If the type cannot be determined or is invalid, Q3ShapePart_GetType returns the value kQ3ObjectTypeInvalid .

Q3MeshPart_GetType

You can use the Q3MeshPart_GetType function to get the type of a mesh part object.



 
TQ3ObjectType Q3MeshPart_GetType (TQ3MeshPartObject meshPartObject);

meshPartObject: A mesh part object.

DESCRIPTION

The Q3MeshPart_GetType function returns, as its function result, the type identifier of the mesh part object specified by the meshPartObject parameter. If successful, Q3MeshPart_GetType returns one of these constants:



 
kQ3MeshPartTypeMeshFacePart

kQ3MeshPartTypeMeshEdgePart

kQ3MeshPartTypeMeshVertexPart

If the type cannot be determined or is invalid, Q3MeshPart_GetType returns the value kQ3ObjectTypeInvalid .

Q3MeshPart_GetComponent

You can use the Q3MeshPart_GetComponent function to get the mesh component that contains a mesh part.



 
TQ3Status Q3MeshPart_GetComponent (

                     TQ3MeshPartObject meshPartObject, 

                     TQ3MeshComponent *component);

meshPartObject: A mesh part object.
component: On exit, the mesh component that contains the specified mesh part object.

DESCRIPTION

The Q3MeshPart_GetComponent function returns, in the component parameter, the mesh component that contains the mesh part object specified by the meshPartObject parameter.

Q3MeshFacePart_GetFace

You can use the Q3MeshFacePart_GetFace function to get the mesh face that corresponds to a mesh face part.



 
TQ3Status Q3MeshFacePart_GetFace (

                     TQ3MeshFacePartObject meshFacePartObject, 

                     TQ3MeshFace *face);

meshFacePartObject: A mesh face part object.
face: On exit, the mesh face that corresponds to the specified mesh face part object.

DESCRIPTION

The Q3MeshFacePart_GetFace function returns, in the face parameter, the mesh face that corresponds to the mesh face part object specified by the meshFacePartObject parameter.

Q3MeshEdgePart_GetEdge

You can use the Q3MeshEdgePart_GetEdge function to get the mesh edge that corresponds to a mesh edge part.



 
TQ3Status Q3MeshEdgePart_GetEdge (

                     TQ3MeshEdgePartObject meshEdgePartObject, 

                     TQ3MeshEdge *edge);

meshEdgePartObject: A mesh edge part object.
edge: On exit, the mesh edge that corresponds to the specified mesh face part object.

DESCRIPTION

The Q3MeshEdgePart_GetEdge function returns, in the edge parameter, the mesh edge that corresponds to the mesh edge part object specified by the meshEdgePartObject parameter.

Q3MeshVertexPart_GetVertex

You can use the Q3MeshVertexPart_GetVertex function to get the mesh vertex that corresponds to a mesh vertex part.



 
TQ3Status Q3MeshVertexPart_GetVertex (

                     TQ3MeshVertexPartObject meshVertexPartObject, 

                     TQ3MeshVertex *vertex);

meshVertexPartObject: A mesh vertex part object.
vertex: On exit, the mesh vertex that corresponds to the specified mesh vertex part object.

DESCRIPTION

The Q3MeshVertexPart_GetVertex function returns, in the vertex parameter, the mesh vertex that corresponds to the mesh vertex part object specified by the meshVertexPartObject parameter.